OMNIGRAPH is an intelligent, easy to use Graphics Printer 
Interface for your Apple computer system. OMNIGRAPH giv 


Ағь | Bi TM your computer the capability to reproduce pictures, ch 

ө a Гл a nd h 1 Пет dot matrix erint inclu . 

~] | and graphs оп ай popular dot matrix printers, including: 

| || mi ГЕ Apple dot-matrix, С. Itoh, Gorilla, IDS, Mannesmann Talley, 
ЕШ Okidata, Star Micronics and more. 


Graphics Printer Interface OMNIGRAPH's on-board intelligence makes operation simple 
for your Apple II" series co: 





















A теат ks or programs required. 





ie 


e needs by offering a versatile 

luding: 
e High resolution s 
Dual split screer 


Zoom graphics 


Pic 


OMNIGRAP 
backed with 


ееееее 


rmance and is 









































































































































































































































































































































| [ |! E | Рр | р 1 | I M ET uer m | | 111 | Б D m ee 
x 4 E ESTER CC EET i 4 1 | 1 | 1 ; ESSI | | | | | L | | | | | | | 
| ds г я 1 | 1 1 7 Г 6 Б mz E Г 
ШЕШЕ! | | (RRR | | E BEEEESEB 
ar (esl T ЕЕЕ ГГ r | | Im uS ie EXE 
ЕШТЕ Елер | | | | | l Li ДЕЛ UM 
1 | | T 1 І I ESTEE н | | = 1 EN I DEG ] Г 
аа ER E ERE EEG ER ERE I ER Lo 96900 
| 1 1 1 1 4 1 1 > ен 3 ! 
НЕШЕ НЫ EBENE | І ашаа i 
ТРТ mn | ЕЕ ӨРІЕІГГІ mmi li | m mm 3l 
1 L ] L | Ве u m = m—— S L | L ] I ZA iL 
1 7 E m mp ЕЕ 1 f Г і r m — EE " БЕР EE EEG Р ma 
Poong Ld |e ee ee а "E RD КЕМ БЕНЕШЕШИ 
ШЕЕЕВЕ нш EH ERES Se RT FFT EBENE | 
= a 1 | | i кі | ж Б 1 І 1 L 
| | І ЕН m m m J E E Bu (ЕН msi | [| | m 
Loud aes = | L i || E Б BA | | | 
EN! Р TE DA Г | oe 5 a ES | pai T | T T r Б 
BS EN | | Siiil ШЕ | 1 ШЕШІ i= 
НІ mI m | [| m | | ih ГТ á ПЕ | | zr 7 
| L Lt iz L- Lif tf Li Ба и — | _| | aoe 
T z= Бай E (ЕГІ E EE FED "ГІ - T-T 1-1 4 
ІШЕ = Е СЕ К ышы | EE | | Шық 
MA SYSTEM MA SYS 
P | | Л- > 7 X 
"na $ STE | % ESSEN B 
IN R 


CORPORATED 
An Enconi Company 


2015 O'Toole Ave., San Jose, CA 95131 
(408) 943-0596 


Omnigraph is a trademark of MA Systems, Inc. 





Omnigraph" 
User's Guide and 
Reference Manual 


) 





000008 


m 
E 
E 
E 
Ш 
E] 
a 
о 
2015 O'Toole Avenue, San Jose, California 95131 (408) 943-0596 


BRERBEREE 
шннинын — 9— À 3 





OMNIGRAPH 


USER’S GUIDE AND 
REFERENCE MANUAL 


TABLE ОҒ CONTENTS 


INTRODUCTION inni am ақыр Fes Bn ERE Фа зара т 4 
INSTALLATION а eec eee cove Fx eas cee өз ЖҰР FER же» 5 
OPERATION „ъа cuss ssw ә coh cane EXTR Ұз ENS feos eee GERE MEE 7 
Turning ON OMNIGRAPH Г4..22Г4.......%.шша aves owe ká 
Turning OFF-OMNIGRAPH .... г... „е saara saena 8 
OMNIGRAPH’s "Wake Up" State ........................ 8 
Issuing OMNIGRAPH Commands ...................... 8 
TEXT COMMANDS „ахаа RAE irian dod scan ааа 10 
Changing the Command Character ..................... 12 
GRAPHIC FUNCTIONS AND COMMANDS ——" 12 


Combining Graphics Commands 
PASCAL and CP/M Compatibility 
Using PASCAL to Print Graphics 


PROGRAMMING TUTORIAL „нл ана see ttt enn 16 





TECHNICAL REFERENCE 
Memory I/O Locations Used by OMNIGRAPH 
Printing Large and Continuous Images .................. 18 


COMMAND REFERENCE TABLE ......................... 19 
TEX COMMANGS әсе ade dansk мекенмен nyc dede Moret dd 
Graphics Commands 












LIMITED WARRANTY 


MA SYSTEMS INC. warrants to the original user of this product that it shall be free 
of defects resulting from faulty manufacture of the product or its components and 
to be in good working order for a period of one (1) year from the date of purchase. 
Defects covered by this Warranty shall, at the option of MA SYSTEMS INC., be 
corrected either by repair or replacement. In the event of replacement, the 
replacement unit will be warrantied for the remainder of the original one (1) 
year period. 


If this product should require service, return it to your original place of purchase, 
along with a copy of your Warranty card with serial number, your proof of purchase 
and a brief explanation of the suspected defect. If you are unable to return this 
product to the original place of purchase, return the product along with the afore- 
mentioned items to: MA SYSTEMS INC., c/o Customer Service Dept., 2015 O'Toole 
Avenue, San Jose, California 95131. 


MA SYSTEMS INC. MAKES NO WARRANTIES, EXPRESSED OR IMPLIED 
INCLUDING BUT NOT LIMITED TO THOSE OF MERCHANTABILITY OR 
FITNESS FOR A PARTICULAR PURPOSE, WHICH EXTEND BEYOND THE 
DESCRIPTION AND DURATION SET FORTH HEREIN. 


THE SOLE OBLIGATION OF MA SYSTEMS INC. UNDER THIS WARRANTY IS 
LIMITED TO REPAIR OR REPLACEMENT OF PRODUCTS WHICH PROVE 
DEFECTIVE WITHIN ONE (1) YEAR OF PURCHASE. MA SYSTEMS INC. 
SHALL NOT, IN ANY EVENT, BE LIABLE FOR ANY INCIDENTAL OR CONSE- 
QUENTIAL DAMAGES OF АМҮ KIND RESULTING FROM USE OR POSSESSION 
OF THIS PRODUCT. 


Some states do not allow limitation of the duration of implied warranties, or the 
exclusion or limitation of incidental or consequential damages. So the above 
limitations or exclusions may not apply to you. This Warranty gives you specific 
legal rights which may vary from state to state. 


Your OMNIGRAPH™ Graphics Printer Interface carton contains 
the following: 

* Graphics Printer Interface- 

* Parallel printer cable 

* User's Guide and Reference Manual 

* Warranty and User Registration Form 
If these items are missing or damaged, please contact your place 
of purchase. 


Omnigraph is a trademark of MA SYSTEMS INC. 
Apple II, II+ and lle are trademarks of Apple Computer, Inc. 
IBM is a registered trademark of International Business Machines Corporation. 


©1983 MA SYSTEMS, INC. 


INTRODUCTION 


Thank you for purchasing your new OMNIGRAPH Graphics Prin- 
ter Interface. OMNIGRAPH will provide you with years of reliable 
performance and satisfaction. You will find your new OMNIGRAPH 
easy to use and versatile to meet your growing needs. 


COMPANY PROFILE 


MA SYSTEMS INC. is a leading manufacturer of enhancement 
products for Apple and IBM personal computers. Our commit- 
ment to state-of-the-art engineering has vaulted our products 
to the forefront of the personal computer industry. It is this 
commitment that provides our customers with maximum product 
satisfaction and unsurpassed reliability. 


Our Research and Engineering departments are continuously 
developing new and innovative products to meet your growing 
needs. We look forward to providing you with our growing line of 
quality products for your computer. 


MA SYSTEMS INC. is a subsidiary of ENCON INCORPORATED, 
a Research and Engineering conglomerate involved in Nuclear 
Engineering. Its subsidiaries are involved in the development, 
manufacturing and distribution of computer and electrical prod- 
ucts for industry, business, home and education. 


A WORD BEFORE YOU BEGIN 


Before you attempt to install your new OMNIGRAPH, please 
read through the User's Guide thoroughly. 


This guide is intended to provide all necessary information for 
the installation and operation of your OMNIGRAPH Graphics 
Printer Interface. If you have any questions not addressed in this 
guide or you encounter difficulty installing or operating your 
OMNIGRAPH, please consult your local computer dealer. 


INTRODUCING OMNIGRAPH 


The OMNIGRAPH Graphics Printer Interface is a plug-in circuit 
board which allows you to reproduce, design and manipulate 
graphics and text on any Centronics standard parallel printer. 
OMNIGRAPH provides these versatile printing capabilities and 
connects your Apple to all popular parallel printers including: 


C. Itoh Mannesmann Tally* Star Gemini 
Epson NEC 8023 Transtar 315 
IDS* Okidata 


*Requires optional ОММІОНАРН version. 
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Your OMNIGRAPH provides an exciting array of graphics and text 
capabilities including high resolution screen dumps, dual hi-res 
screen dumps, color graphics reproduction on color printers, 
zoom graphics, inverse graphics, 90° picture rotation, left and 
right margin controls, page and line length controls and more. 
OMNIGRAPH's on-board intelligence makes operation easy 
and convenient — no disks or programs required. OMNIGRAPH 
provides its versatile selection of dazzling effects by using simple 
control commands. And OMNIGRAPH is compatible with PASCAL 
and CP/M. 





INSTALLATION 


Installing OMNIGRAPH in your personal computer is easy and 
requires only a few minutes. To ensure simple, safe installation, 
please follow these instructions. 


Your OMNIGRAPH is designed with a switch set, commonly 
referred to as a “dip switch,” which allows you to connect a wide 
selection of popular printers to your computer. Specific instruc- 
tions for setting the appropriate switches for the desired printer 
are provided in this section. 


Here is a picture of OMNIGRAPH. Connectors and switches 
are pointed out. Study this picture to familiarize yourself with 
this board. 


OMNIGRAPH’s Intelligence (EPROM) Cable Connection 






-Dip Switch — 
Printer Selection 


Turn the power OFF to your computer and all connected 
peripherals. WARNING: Never install or remove devices from 
your computer with the power ON as this will result in serious 
damage. 


Most of the printers available use different methods and com- 
mands to accomplish their respective graphics capabilities. 
Because of this non-standardization, your OMNIGRAPH 
provides a set of switches which configures your computer 
system for the unique characteristics of your printer. 


The OMNIGRAPH dip switch is located in the rear bottom 
section of the board as shown in the previous photograph. 
The dip switch has four switches labeled 1, 2, 3 and 4. The 
ON side of the dip switch is marked with either a plus (+) sign 
or the word “ON.” 


Make the appropriate switch settings on the dip switch. Use 
the table below to determine the required switch setting for 
your printer. 


Printer Switch # 
1 2 3 4 
Okidata 82, 83, 84, 92, 93 ON ӨРЕ OFF OFF 
Transtar 315 OFF ON OFF OFF 
C. Itoh 8510/NEC 8023 ON ON OFF OFF 
Epson series/Star Gemini OFF OFF OFF OFF 


Now you are ready to install OMNIGRAPH into your computer. 


Remove the cover from the Apple. First, grasp the rear edge of 
the cover at its corners and gently pull UP just until the corner 
fasteners pop apart. Then slide the cover in the direction away 
from the keyboard until it is removed. 


The internal circuitry of your computer is now visible. As you 
view this circuitry, looking from the keyboard (front) to the 
back panel (rear), you will notice a row of peripheral con- 
nectors, referred to as "slots" (the Apple Ile contains seven 
slots and the 11+ contains eight). The leftmost slot is desig- 
nated as slot #1 for the Ile and slot #0 for the 11+. NOTE: 
OMNIGRAPH MUST NOT BE INSTALLED IN SLOT #0. 


Though OMNIGRAPH is "slot independent,” meaning that it 
can be installed in any available slot except 0, most programs 
look for the printer interface to be located in slot #1. We 
strongly recommend that you install your OMNIGRAPH in 
slot Q1. NOTE: When using PASCAL and CP/M, OMNIGRAPH 
MUST be installed in slot #1. 








5. You will notice an extended lip with gold “fingers” on the 
bottom of your OMNIGRAPH. Install the OMNIGRAPH by 
holding the top of the board and gently inserting these fingers 
into one of the available slots (preferably slot #1). Press the 
board firmly into place making sure that it is securely seated. 


6. Next, slide the cable through one of the openings in the 
Apple’s rear panel. 


7. Replace the Apple’s cover. Slide the cover towards the Кеу- 
board until it goes no further, then press down on the rear 
corners until they fasten into place. 


8. Connect the universal OMNIGRAPH cable to your printer. 
WARNING: Make sure that the printer is OFF when connecting 
and disconnecting the cable. 


9. Turn your Apple and printer ON. You will see the prompt “]” 
іп APPLESOFT or “>” in INTEGER displayed. To test the 
OMNIGRAPH, type: PR#S (where S = the slot # of the OMNI- 
GRAPH). Press the RETURN key a few times. The printer 
should now be operating and printing a prompt character 
each time you press the RETURN key. 


If this does not occur, make sure that the printer power is ON, 
that the printer is on-line to the computer and check to ensure 
that OMNIGRAPH has been installed properly. 





OPERATION 


With installation completed, you are now ready to use your 
OMNIGRAPH. The following section provides you with all of the 
necessary information for operating your OMNIGRAPH. 


TURNING ON OMNIGRAPH 
To turn your OMNIGRAPH ON, you must: 
When using APPLESOFT or INTEGER, type: 
PR#S (RETURN) (where S = the slot # of OMNIGRAPH) 


When using PASCAL and CP/M, simply follow their standard 
printing commands. 


TURNING OFF OMNIGRAPH 
To turn your OMNIGRAPH OFF, you must: 
When using APPLESOFT or INTEGER, type: 
PR#0 (RETURN) 
When using PASCAL or CP/M, simply follow their standard 
printing commands. 
OMNIGRAPH'S “WAKE UP" STATE 


When OMNIGRAPH is turned ON, it is pre-set for the following 
printing functions: 


1. To send an Automatic Line Feed to the printer when it receives 
a carriage return command (RETURN key) in BASIC. Auto- 
matic line feed is OFF in PASCAL and CP/M. 


For 255 characters per line. 

Left margin = 0. 

Right margin = 255. 

Paging feature is turned OFF. 

Video Echo: ON in BASIC. OFF in PASCAL and CP/M. 
BELL: OFF. 

Current command character: CTRL-I. 

Most Significant Bit (MSB): Masked to 0 (set low). 


о PNOTA YD 


instructions for changing these options are given in the follow- 
ing sections. 


ISSUING OMNIGRAPH COMMANDS 


OMNIGRAPH uses one of Apple’s special keys to activate its 
functions. This key is the CONTROL key, marked “CTRL.” The 
CTRL key is located on the left, center section of the Apple 
keyboard. We will frequently refer to the use of the CTRL key 
throughout this guide. 


To activate OMNIGRAPH functions, you will use the command 
sequence: CTRL (key) ! (key). 


NOTE: Remember, before selecting OMNIGRAPH functions, 
make sure that OMNIGRAPH has been turned on using the 
“PR#S” command (where S = the slot # of OMNIGRAPH). 
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To activate ап OMNIGRAPH command from the keyboard, press 
the CTRL and “I” keys SIMULTANEOUSLY. Then, release 
these keys and press the key or keys corresponding to the 
OMNIGRAPH function you want to use. Do not enter spaces or 
punctuation marks. 


As an example, let's see how you would turn OFF OMNIGRAPH's 
Automatic Line Feed function, CTRL-I K. 


Assuming OMNIGRAPH has been turned ON, you would: 
1. Press the CTRL and "I" keys simultaneously. 

2. Release the "I" key, then the CTRL key. 

3. Press the "K" key. 


Following these steps, your OMNIGRAPH will be instructed not 
to generate an automatic line feed to your printer when it receives 
a carriage return command. 


You can also activate OMNIGRAPH functions from within 
programs. BASIC "PRINT" statements are used to activate 
these functions. 


For our previous example, here is how you would activate the 
command from a BASIC program: 


In APPLESOFT: 10 PRINT CHR$(9);"K" 
In INTEGER: 10 PRINT “CTRL key* ІК” 


NOTE: CHR$(9) is the BASIC programming value for CTRL-I. 
Control commands do NOT appear on your display 
when entered from the keyboard.* Press the “CTRL” key. 


ОММІСВАРН does not activate special printer functions nor alter 
printer command codes. Each printer's command codes operate 
independently of OMNIGRAPH. To activate a printer's special 
modes, such as correspondence quality or condensed print, enter 
the appropriate printer commands as detailed in the printer's 
manual BEFORE you turn OMNIGRAPH ON. 





TEXT COMMANDS 


The following is a list of the commands used to activate OMNI- 
GRAPH text functions. An example of activating these com- 
mands within an APPLESOFT BASIC program is provided for 
each command. 


Command 
Sequence 
Entered from 
the Keyboard Description 


CTRL-I A Turns ON the Automatic Line Feed function. A line 
feed will be sent їо the printer when OMNIGRAPH 
receives a carriage return command. 

PRINT CHR$(9);"A" 


CTRL-1 B Turn ON bell. This allows the CTRL-G bell charac- 
ter to be sent to the printer. 
PRINT CHR$(9);"B" 


CTRL-I C Turn OFF bell. This prevents the bell character 
from being sent to the printer. 
PRINT CHR$(9);"C" 


CTRL-I H The Most Significant Bit (MSB), the 8th bit, is sent 
to the printer. This function has no effect on many 
printers. However, with some printers, this com- 
mand allows the printing of graphics or special 


characters. 
PRINT CHR$(9);"H" 
CTRL- I Sends characters to both the video display and the 
printer. This is known as "video echo." 
PRINT CHR$(9);"I" 
CTRL-I K Turns OFF the automatic line feed function. 


OMNIGRAPH will not generate a line feed to 
the printer when it receives a carriage return 
command. NOTE: This overrides the CTRL-I A 
command. 

PRINT CHR$(9);"K" 


CTRL-I nL Sets the left margin to “n,” where “n” is between 0 
and 255. The printer will begin printing after the 

“nth” column position. 

PRINT CHR$(9);"nL" 
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CTRL-I nN 


CTRL-I nP 


CTRL-I nR 


CTRL-I S 


CTRL-I 25 


CTRL-I X 





Sets the characters per line length to "n" char- 
acters. "n" can range from 0 to 255. After this 
function has been activated, characters will NOT 
be sent to the display. (To re-activate the video 
display, use the CTRL-I | command). 


The printer will generate an automatic carriage 
return command after "n" characters have been 
printed. 


NOTE: When listing BASIC programs, printing will 
be formatted for 40 columns unless the format has 
been changed using this command. 


PRINT CHR$(9);"nN" 


Set number of lines per page to "n." The printer will 
generate six line feeds after "n" lines have been 
printed. To turn off this page length function, type 
СТНІ-І ОР. 


Typical page length is 66 lines. Therefore, for 
most uses, set the page length to 60, so that your 
printer will issue six line feeds to skip over the 
form perforation. 


PRINT CHR$(9);"nP" 


Sets the right margin to the "nth" column. "n" can 
range from 0 to 255. This function will end the 
line at the first space that occurs after the 
"nth" column. 


PRINT CHR$(9);"nR" 


Duplicates the current 40 column text display on 
your printer. The text display will be printed 20 
spaces from the leftedge ofthe paper. Text display 
will only be printed in 40 columns. This function 
may be incompatible with some 80 column video 
boards. 


PRINT CHR$(9);"S” 


Duplicates the text screen memory located in 
pages 1 and 2. These pages are printed side by 
side for 80 column output. NOTE: This function 
may not be compatible with some 80 column 
video boards. 

PRINT СНН%(9);“25” 


Disables the output of the Most Significant Bit 
(MSB) to the printer. Sets the value of MSB to 0. 
PRINT CHR$(9);"X" 
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CHANGING THE COMMAND CHARACTER 


The standard OMNIGRAPH command character which activates 
selected functions is CTRL-l. If you wish, you may redefine the 
control command character to any other letter. 
To redefine the control character, issue the command: 

CTRL-X CTRL-Y (where X is the current CTRL character and 

Y is the desired CTRL character) 

For example, we want to change the command character to 
CTRL-W. To do this, we would issue the command: 


CTRL-I CTRL-W 


GRAPHICS FUNCTIONS 
AND COMMANDS 


OMNIGRAPH offers a versatile array of graphics functions. These 
graphics functions are initiated by using the simple command: 


CTRL-I “G” 
This command is then followed by the command character of the 
listed graphics functions and activated by pressing the RETURN 


key. OMNIGRAPH allows you to reproduce images on your printer 
from either page 1 or 2 of HIRES (high resolution) graphics. 


PROGRAMMING NOTE: To activate OMNIGRAPH's graphics 
functions from within a program, use the same BASIC format as 
previously described. Example: 


PRINT CHR$(9);"Gx" (where "x" is the command character of 
the selected function) 


NOTE: We will refer to pages 1 and 2 in this section. Page 1 and 2 
graphics are the image displayed on the Apple screen. BEFORE 
you print graphics, make sure that OMNIGRAPH's switches have 
been properly set for your printer. 


The OMNIGRAPH graphics functions are: 


Command 
Sequence Description 


CTRL-T G Prints page 1 of HIRES graphics. 
CTRL-I G2 Prints page 2 of HIRES graphics. 
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СТНІ-І GI 


CTRL-I GR 


CTRL-I GD 


CTRL-I GC 


CTRL-I GE 


Prints the inverse image of graphics page 1. 
Normally, a white dot on the display is reproduced 
as a black dot on the printer paper. This com- 
mand will print the background portions of the 
display as black on the printer paper, thus repro- 
ducing the displayed image as it appears on the 
Screen. This function is particularly useful for 
pictures and portraits. 


Rotates graphics image (page 1) 90? in a clock- 
wise direction. NOTE: Some printers may require 
this function when printing a double size (zoom) 
image (see CTRL-I GD). 


Zoom graphics. Prints a double size graphics 
image from the screen. Some printers, such as the 
Epson MX-80, FX-80 and Okidata 82A, 92 do not 
have enough character positions to print a double 
size image horizontally. Therefore, to print the 
double size image properly, the image must be 
rotated 90° using the CTRL-I GR command. 


Images will be printed in color with color printer. 
You can use this function if you have either mono- 
chrome (single color) or color display. The colors 
of the image are determined by the software 
package you are using. When you activate this 
command, the software package will send the 
color values of each text or graphics character to 
the printer. If you wish to change the printed 
colors, refer to the software and printer manuals. 
THIS FUNCTION IS VERY USEFUL WITH THE 
TRANSTAR 315 PRINTER. 


Prints ап "emphasized" image of the screen. 
"Emphasized" means adding more dots to the 
characters, creating a more fully-formed, clearer 
character. The printer will printtwo closely spaced 
dots for every one it would normally print. 


NOTE: The Transtar 315 does not support 
the "R" or "E" graphics functions when printing 
color graphics. à 
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COMBINING GRAPHICS COMMANDS 


OMNIGRAPH allows you the flexibility of combining more than 
one graphic function in your graphics command. For example, if 
you want to print the inverse of page 2 graphics, double size and 
rotated 90°, you would enter: 


CTRL-I GI2DR (RETURN) 


The order in which you enter "I2DR" does not effect the activa- 
tion of the function. All functions will be activated. But note: 1) the 
CTRL-I С command characters must precede the selected func- 
tion characters; 2) the entire command must be activated by 
pressing the RETURN key. 


PROGRAMMING NOTE: When you are using APPLESOFT 
BASIC, you will get a SYNTAX ERROR message when entering 
commands from the keyboard. This occurs because BASIC 
attempts to interpret these commands as BASIC program state- 
ments — which the CTRL commands are not. This occurrence 
is merely a nuisance and has no effect on the activation or opera- 
tion of the selected function. If the SYNTAX ERROR message is 
too bothersome, issue commands from PRINT statements as 
described in this section. 


PASCAL AND CP/M COMPATIBILITY 


Your OMNIGRAPH is compatible with both PASCAL and CP/M. 
Both require the OMNIGRAPH to be installed in slot #1. 


Since the command character, CTRL-I, is used in PASCAL and 
CP/M for tabbing, OMNIGRAPH automatically changes the 
command character to CTRL-Y (internal to the board) to avoid 
any incompatibilities. Use the CTRL-Y command to activate 
functions. 


Both PASCAL 1.0 and CP/M use the same Input/Output memory 
location that OMNIGRAPH uses to activate the right margin 
function. To eliminate any incompatibility, the right margin func- 
tion is disabled when using PASCAL 1.0 and CP/M. The right 
margin function remains active when using PASCAL 1.1. 





USING PASCAL ТО PRINT GRAPHICS 


The following program demonstrates how to print graphics from 
PASCAL. To stop the program, hit any key on the Apple keyboard. 


This program uses PASCAL turtlegraphics. 


PROCEDURE CRAWL; 
BEGIN 


MOVE (2*DISTANCE) 
TURN (ANGLE); 
END; 


BEGIN 

REWRITE (OUT,'PRINTER’); 
ANGLE:=30; 

REPEAT 

INITTURTLE 

PENCOLOR (WHITE); 

FOR DISTANCE:= 1 TO 50 
DO CRAWL; 


ANGLE:-ANGLE + 10 

WRITELN(OUT,CHR(25),'G'); 
WRITELN(OUT,CHR(25),‘GR’); 

UNTIL KEYPRESS ы 
END. 


PROGRAMMING NOTE: When you are setting the right margin 
and line length you should turn the automatic line feed ON. This 
is necessary, because OMNIGRAPH sends a carriage return to the 
printer when printing reaches the right margin or defined line 
length. If you do not have an automatic line feed enabled, the 
printer will overwrite on the same line. 


PROGRAMMING TUTORIAL 


This section will guide you through the use of OMNIGRAPH 
functions and how to activate these functions from within a 
program. Specific examples are provided to guide you and 
demonstrate the procedures. 


Here is a short tutorial on outputting to the printer from APPLE- 
SOFT BASIC using PRINT statements. This program will 
demonstrate the use of the BASIC TAB function and the “L” 
command. 


NOTE: When “PR#S” is shown, S= the slot # of OMNIGRAPH. 


If you are not using Apple DOS, you do not need to enter the 
“CHR$(4)” command. 


10 PRINT CHR$(4):“PR#S” 

20 PRINT CHR$(9);"20L" 

30 PRINT "HAVE A GOOD DAY" 

40 PRINT ТАВ(20);“НАУЕ A GOOD DAY" 

50 PRINT CHR$(4);"PR&0":REM TURNS OFF PRINTER 
60 END 

RUN 


This program demonstrates the use of CTRL-I nN, setting the line 
length. In this case, 10 characters per line. 


10 PRINT CHR$(4);“PR#S” 

20 PRINT CHR$(9);10N" 

30 PRINT “1234567890123456” 
40 PRINT CHR$(4);“PR#0” 

50 END 

RUN 


This program demonstrates the use of CTRL-I nR, setting the 
right margin. In this case, we are setting the right margin at the 
40th column. 


10 PRINT CHR$(4);“PR#S” 

20 PRINT CHR$(9);"40R":REM SETS RIGHT MARGIN TO 40. 

30 PRINT "WE HOPE THAT YOU ARE PLEASED WITH YOUR 
NEW OMNIGRAPH, AND THAT THIS MANUAL IS HELPFUL" 

40 PRINT CHR$(4);"PR&0" 

50 END 


Notice that the right margin function did not end the line with a 
separated word. Now try the same program but with the right 
margin set to the 30th column. 
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This program demonstrates the use of CTRL-I B, turning the bell 
ON (If your printer has an operable BELL). 


10 PRINT CHR$(4);"PR&S" 

20 PRINT CHR$(9);“B”:REM TURNS BELL ON 
30 PRINT CHR$(7) 

40 PRINT CHR$(4);"PR#0” 

50 END 


This program demonstrates the use of CTRL-I C, turning the 
bell OFF. 


10 PRINT CHR$ 
20 PRINT CHR$ 
30 PRINT CHR$ 
40 PRINT CHR$ 
50 END 


NOTE: If video echo is ON, you will hear the BELL from the 
computer. ! 


РАЯ” 


4); 
9);“C”:REM TURNS BELL OFF 
7 

4); 


“РН0” 


This program demonstrates the command which redefines the 
command character. In this case, we will change the command 
character from CTRL-I to CTRL-Y. 


10 PRINT CHR$(4);"PR#S” 

20 PRINT CHR$(9);CHR$(25) 

30 PRINT CHR$(25);"K" 

50 PRINT "HAVE A GOOD DAY" 
60 PRINT "BE HAPPY" 

70 PRINT CHR$(4);"PRIO" 

80 END 


This program demonstrates the method for sending graphics to 
the printer. In this program, replace “FILENAME” with any actual 
filename that contains a graphic image. 


10 PRINT CHR$(4);" PRAS" 

20 PRINT CHR$(4);“BLOAD FILENAME, A$2000" 
30 PRINT CHR$(9);“G” 
40 PRINT CHR$(9);"G2R" 
50 PRINT CHR$(4);“PR#O” 


TECHNICAL REFERENCE 
MEMORY I/O LOCATIONS USED BY OMNIGRAPH 


OMNIGRAPH uses І/О memory locations pertaining to the slot 
in which it is installed and "scratchpad" memory locations. The 
OMNIGRAPH entry points and various memory locations are: 


(NOTE: S = slot # of OMNIGRAPH) 


COLD START-UP: $CS00 

WARM START-UP: $CS06 

LINE LENGTH: $478+0S 

PAGE LENGTH: $4F8+0S 

LINE COUNTER: $5F8+0S 

RIGHT MARGIN: $678+05 

LEFT MARGIN: $6F8+0S 
COMMAND CHARACTER: $778+0S 
CHARACTER COUNTER: $578+05 
TEXT FLAGS: $7F8+0S 


TEXT FLAG SETTINGS 
Bits 0,2-4: Reserved 


Bit 1: Line feed ON 
Bit 5: Turn bell ON 
Bit 6: Output to screen 
Bit 7: Output MSB 


PRINTING LARGE AND CONTINUOUS IMAGES 

You can print large and continuous graphic images on your 
printer with OMNIGRAPH. This can be done by loading portions 
of the graphics images to the display and then sending them to 
your printer. 


The following program demonstrates how to print the entire image 
of two graphics pages so that the images appear continuous. 


10 PRINT CHR$(4);"BLOAD РІС1,4%2000” 

20 PRINT CHR$(4);“BLOAD PIC2,A$4000" 

30 PRINT CHR$(4);“PR#1” 

40 PRINT CHR$(9);"GR" 

50 PRINT CHR$(9);"G2R" 

60 END 

You can accomplish the same continuous printing using another 
method. Simply, load a portion of the image into graphics memory 
and then send it to the printer. You send one portion at a time, one 
after the other, until the entire image is printed. 


(Note that you are using the picture rotation function, CTRL-I GR, 
to make the image appear continuous.) 
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COMMAND REFERENCE TABLE 


TEXT COMMANDS 


COMMAND 


CTRL-I А 
CTRL-i B 
CTRL-I C 
CTRL-I H 
CTRL- I 
CTRL-I K 
CTRL-I nL 
CTRL-I nN 
CTRL-I nP 
CTRL-I nR 
CTRL-I S 
СТНІ-І 2s 
CTRL-I X 


FUNCTION 
Automatic Line Feed ON. 
Bell ON. 
Bell OFF. 


MSB's present value is sent to printer. 
Video echo ON. 

Automatic Line Feed OFF. 

Set left margin to "n" 
Set line length to "n" 
Set page length to "n" 
Set right margin to "n" 

Print page 1 of text. 

Print pages 1 & 2 of text memory side by side. 


Sets MSB to 0 value. 


GRAPHICS COMMANDS 


CTRL-I G 

CTRL-I G2 
CTRL-I GI 

CTRL-I GR 
CTRL-I GD 
CTRL-I GC 
CTRL-| GE 


Print page 1 of graphics. 

Print page 2 of graphics. 

Print inverse of graphics. 

Rotate picture 90? 

Zoom graphics (double size) 

Print image in color on color printer 
Print “emphasized” image 
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